[ <<>> ] Succubus Heart [ <<>> ]
[<>] The Succubus Gameplay Mod [<>]

created by : Michael Stanich aka Spirit Shard
Site - michaelpstanich.com
YouTube - youtube.com/michaelpstanich

[ <<>>] Self Promotion [ <<>> ]
So.. I work hard on the mod, but I also work hard at making YouTube Videos! If you're looking for a great Gaming and Design focused YouTube channel and creator please check me out at https://www.youtube.com/michaelpstanich !

[ <<>> ] Latest News [ <<>> ]
Succubus Heart 4.16 is released! This comes with some simple bug/error fixes and adds in a basic framework for 'Perks' which will be expanded in the future.

Succubus Heart 4.14 and forward will require the Dawnguard and Dragonborn DLC! Please use 4.12/4.13 if you don't have the DLCs.

Just in-case anyone is curious, yes I plan to make a Skyrim SE version, however I need SKSE and Sexlab to be updated before I can do so, which sounds like it may be a while. (I'll try and keep up-to-date the best I can)

 _____

[ <<>> ] What is Succubus Heart? [ <<>> ]
Succubus Heart is an adult gameplay mod focused on creating new ways to approach playing Skyrim with both new progression and new game mechanics. These mechanics give the player the power of a succubus enabling the use of life-drain and great sacrificial powers. Succubus Heart is built around the idea of being a complimentary mod and should be compatible with nearly every mod out there!

[ <<>> ] What's So Unique? [ <<>> ]
Succubus Heart isn't a transformation mod, or a power fantasy mod, instead mechanics are focused on making gameplay more interesting and offering the player new ways to approach situations. Succubus Heart can also be used on male characters, turning them into a soul sucking Incubus! While most succubus mods focus on the demon-archtype Succubus Heart's approach is based on a fantasy race of life-weavers giving a more human-but-powerful vibe. However if you want some succubus transformations or want to use Succubus Heart alongside other succubus mods nothing is stopping you!

[ <<>> ] Mechanics [ <<>> ]
Heart System : Your succubus will earn XP through sexual acts and certain items which can be spent to learn new and improve their existing abilities! You'll also absorb life force from your partners, permanently decreasing their status while improving your own!

Skill Leveling : Take your overflowing life force and level Skyrim's usual Skills using SP earned. You can also convert any unwanted XP into SP if so desired.

Sex Drops : Orgasms will give partners their special juices (Sperm and Milk) which can be consumed or used in alchemy! There's also a chance at getting rare drops which have special effects when consumed (or you can be boring and use them in alchemy...).

Death Drops : After death characters will keep a small soul item which can then be taken and used by the player for various bonuses.

Succubus Passives : Unlock and rank up a variety of Succubus Passives which give advantages in combat, make progression run more smoothly, or just makes things a bit more... appealing.

Soul Pets : Another mod fully integrated into Succubus Heart with unique features! Soul Pets are summonable followers (both creature and human) which level through acts. As levels increase not only do pets become more powerful but the summoner's abilities improve adding new bonuses and unlocking more summons!

Combat Seduction : A simple combat submit mod, built right in! Initially built for testing, the feature can be handy if you're looking for a light-weight alternative to other submit mods. However I recommend disabling this feature if you have other submit mods running to avoid issues.

Death Override Mode : (Currently in early development phases and may be error prone) A simple Death Alternative which respawns the player when health hits 0 instead of just prompting a reload. You can even turn Skyrim into a 'rogue-lite' by enabling item loss on death, introducing new gameplay approaches! I recommend leaving this disabled if you use any other Death Alternative type mod.

[ <<>> ] Help Section (Included in-game) [ <<>> ]
[Spoiler]
Basic Mechanics
 - Earning XP
 - - - XP [Short for 'Heart XP'] is obtained through Sex Acts and various items [such as milk/sperm]. XP can then be spent on various upgrades for your character. [Advanced notes available]
 - Earning SP :
 - - - SP [Short for 'Skill Points'] is obtained when absorbing over the max-status allowed. When status is absorbed, any amount over the player's cap is turned into 'Force', then once enough Force is obtained an SP is earned. SP can then be spent on leveling Skills. Optionally XP can be converted into Force to earn SP more quickly. [Advanced notes available]
 - Desire :
 - - - Desire generates naturally over time [this value can also be configured in the Settings Menu]. Desire is consumed in Sex Acts and by some Passives to provide a bonus. Optionally in the Settings Menu negative effects can be added to having high Desire. [Advanced Notes Available]
 - Absorption :
 - - - While in Sex Acts a Succubus/Incubus will drain partners of their Status, taking Max Health/Magicka/Stamina and increasing their own Max Health/Magicka/Stamina. When the player is involved the amount absorbed is determined by their Absorption Stats [which can be leveled with XP] however they can only earn Status up to their Cap [The Status Caps increase by 2 each Player Level and can also be increased with XP]. NPC Absorption stats and caps are all based on Level. [Note : When player is an aggressor 20% is added, while as a victim 20% is subtracted]
 - Stacks :
 - - - Sex/Sperm/Milk Stacks are earned by Orgasms/Consuming Sperm/Consuming Milk and are used by Passives for different bonuses. Instead of being Consumed Stacks Decay over time. Sex Stacks will decrease by 1 every 5 minutes, while Sperm/Milk Stacks will decrease by 1 every minute. Max Stacks and Stacks Earned can be increased with XP and Passives respectively. [Note: Stacks can't go below Zero.
 - Sex Drops :
 - - - Sex Drops are items obtained through character Orgasms. There are 2 types of Sex Drops, Basic and Rare. Basic drops are Sperm and Milk, these are always given to a character's partner when they orgasm. Rare Drops are special items given along-side sperm/milk, these items give large bonuses to the player and are fairly value-able, but they don't always drop and are fairly rare.
 - Death Drops :
 - - - Death Drops are items obtained from characters that die. When a character dies a 'Soul' item is added to their inventory, which can then be looted by the player. These souls provide different bonuses and act as a stable way for the player to progress without Sex Acts. These drops range from common to rare.
 - Soul Pets :
 - - - Soul Pets is external mod, integrated fully into Succubus Heart! Soul Pets allows several pets to be summoned, each gaining XP as they fight or participate in Sex Acts. Upon a Pet Level, Summoner XP is gained, which can then increase the Summoner Level. To unlock new Pets and Abilities higher Levels will be required. Pets also generate Desire when no pet is summoned, however when summoned they consume desire and when reaching zero, or below, they will be un-summoned.
 - Succubus Realm :
 - - - The Succubus Realm [which can be entered/exited using the connect/disconnect spells provided, fast travel can also be used to exit] is the 'Realm of the Heart' and acts as another world separated from Skyrim. This realm contains Succubus and Incubus NPCs along with a location for the player to explore. The Realm Entrances also provide a decent 'home base' location.
 - Combat Seduction :
 - - - Combat Seduction is a built-in Combat Submit mod! This feature has characters fall victim to aggressors [starts sex acts] when characters fall below the configured Health Thresholds. Combat Seduction is built to be light weight however it lacks any advanced features, so while it stands on it's own fairly well those looking for advanced features should make sure to disable this if they use any other Combat Submit mod.
 - Death Override :
 - - - Death Override Mode is a built-in Death Alternative mod! With this feature the player will transport back into the Succubus Realm instead of dieing. Various effects can be configured to customize what effects this has. Disable if you use any other Death Alternative mods, or else things WILL break. [Note: The core design of Death Override Mode is to create Rogue-light features and encourage careful play]

Advanced Mechanics
 - Tracking :
 - - - Use the 'set to default' key on anything that requires XP to level and the required XP will be tracked (Will show a 'Tracking Set' message if done properly). Upon obtaining the proper XP a notification will let you know the selected ability can be level.
 - XP Mechanics :
 - - - When earning XP a few factors go into play, the base earning value [Determined by the act/item/spell/mod], Player level [adds a small bonus to the base value, determined by the act/item/spell/mod], XP Gain Stat [As expected, if the base is 10XP with a 110% XP gain stat, you earn 11XP instead], and Desire [Explained in Desire Consumption]. [Note : When player is an aggressor 20% is added, while as a victim 20% is subtracted]
 - SP Mechanics :
 - - - SP requires Force to obtain, however the required amount is modified in a few ways. For every SP earned through Force Conversion [reaching the required Force value] the cost for another SP increases, however the value needed decreases with each Player Level. The Force Master Passive can also decrease the Force requirement.
 - Desire Consumption :
 - - - Desire currently only offers boosts within Sex Acts. While in an Act 5% Desire is consumed each tick and is added directly into the XP earned that tick. Upon orgasm 80% Desire is consumed and added directly into the XP earned.
 - BDSM Rating :
 - - - Body Desire Soul Mind rating represent the Player Character's Succubus Rating. Improving different abilities will increase the overall BDSM Rating while learning Passives will decrease this rating, both improving abilities and learning Passives will increase different traits. BDSM will display a dominate trait based on the rating with the highest value, which can then alter the effects of some Passives.
 - Passives :
 - - - Passives will give the Player Character 'always on' abilities which trigger under specific conditions. Each Passive may have multiple paths which will change different aspects of each passive and can be ranked up just like abilities. BDSM Rating is required to learn Passives, acting similar to XP or SP and increasing as the Passive levels, however Passives can be reset at any time, returning the BDSM Rating to where it was.
[/Spoiler]

[ <<>> ] WARNING : Script Mod [ <<>> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If your game is already having issues with script latency and overload I recommend backing up your saves before trying out Succubus Heart (and/or possibly decreasing your script load). I've done what I can to ensure Succubus Heart is as bug/error free as possible however under script lag any mod can begin throwing up errors and I can't guarantee Succubus Heart's performance.

[ <<>> ] What's Included [ <<>> ]
- Docs (Read Me - ChangeLog - Source Notes)
- Data (Everything for the core mod)
- Optional Uncapper Settings (Customized Skyrim Com. Unc. Settings)

[ <<>> ] Requirements [ <<>> ]
- Skyrim (Vanilla)
- SKSE 1.07.03 or newer [ http://skse.silverlock.org/ ]
- SexLab v1.62 or newer
- Sky UI 5.1 or newer [ http://www.nexusmods.com/skyrim/mods/3863/? ]

[ <<>> ] Recommended Mods [ <<>> ]
- Skyrim Community Uncapper [ http://www.nexusmods.com/skyrim/mods/1175/? ]

[ <<>> ] Installing / Updating [ <<>> ]
Installing : Simply copy Succubus Heart's "Data" folder to your Skyrim install, merging with that "Data" folder, then install any optional content you wish to use.

Updating : If you're using version 2.73x or below you'll need to do a 'clean' save before moving to 3.0+.

[ <<>> ] Uninstalling / Removal [ <<>> ]
Disable the mod then perform a clean save. After the clean save delete the "Succubus Heart.esp" and all files pre-fixed with "SuH_" and other files from the Succubus Heart mod from your Skyrim's "Data" folder. It is recommended to either load a game from before you had Succubus Heart installed or start a new game after uninstalling.

[ <<>> ] External Mod Support [ <<>> ]
Succubus Heart features are easy to access and modify, if anyone wants to create add-ons and additional mods feel free! If you have questions or any issues feel free to message me.

[ <<>> ] Incompatible Mods [ <<>> ]
- AFT/UFO (Advanced Follower Tweaks / Ultimate Follower Overall) is incompatible with Soul Pets. While using these mods expect issues when using Soul Pets. (and no, I can't fix them, AFT/UFO need to be updated with skyrim's creature handling.)
- Any mod that 'locks' player status or tries to manage stats based on non-dynamic values. (Succubus Heart dynamically changes values and can have issues with mods that try to do this with Skyrim's default values without dynamically checking. Sadly this is on them and there's nothing I can do about it.)
- Regal Glow applies an 'invisible' armor and can cause some issues with mods detecting nudity. In these cases add an exception to 'SuH_armor_regalglow' or the blank name entry in the mod's exception MCM (if it has one).

[ <<>> ] Known Issues [ <<>> ]
- Horse Pet may fast travel with you if you don't already own a primary horse.
- Using Soul Pets with other Animal Follower mods may cause strange behavior on both mods. (I recommend not summoning a Soul Pet while the other Animal Follower is following you)
- Soul Pets will sometimes and sometimes not teleport to the player when they should or shouldn't, if your pet is missing just re-summon them.
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Death Override Mode can cause major issues with certain quests if you die and move outside of the quest's dedicated area. (When in this situation disable Death Override for the quest's duration)
- General script latency problems do to the nature of script modding (Heavy script lag may cause issues with Succubus Heart)

[ <<>> ] FAQ [ <<>> ]
Q: Can I still level like in vanilla?
A: Of course! Succubus Heart doesn't alter any external scripts so other leveling methods should work as they always have.

Q: Can I use this mod as a male character?
A: Yep! Succubus Heart supports both genders.

Q: The MCM isn't showing and nothing seems to work!
A: Sounds like something installed incorrectly, try a clean install of the mod and make sure your files downloaded/extracted properly.

Q: _____ feels overpowered / underpowered, can you balance it?
A: I can try! If you have balance concerns make sure to send them my way and I'll work my best to work on it.

Q: I thought Soul Pets was going to be a completely separate mod, why is it now integrated?
A: In honesty I completely screwed up the stand-alone's code so instead of re-writing from scratch (again) I just moved onto making an integrated version first. I'll work on the stand-alone version at some point.

Q: But I didn't want Soul Pets, can it be removed?
A: No, however I've built it in such a way that it doesn't do anything if you don't use it so just ignore the Soul Pets MCM if you don't want to use it. Sorry!

Q: You're not making anymore Succubus Spells? What is "Legacy"?
A: Legacy refers to features that are in the mod but no longer supported, I didn't really feel like 'removing' more content in-case people wanted to still use it. As for spells I'm still working on Seduction (sex) spells but combat and support spells were impossible to balance and didn't really add to the mod in any interesting ways, so I'm spending that development time elsewhere.

Q: Why did you re-write the mod and end up removing features?
A: Removing features was never part of the plan but rather just a side effect. The original write was based on a flawed framework and the entire mod had become a grouping of work-around, causing bugs which I couldn't fix. The re-write allowed me to rebuild the foundation and build a more cohesive mod with better mechanics and synergy.

Recent Changes (Check the full changelog for more info)
[Spoiler]
Succubus Heart 4.16
- Added Perks MCM menu (system is WIP - Suggestions wanted!)
- Added Perk "Have Orgasm" - +12 BDSM per-rank
- Fixed Formal Beauty now shows the timer value in the description
- Fixed Pets can now only register losing desire on hit once every 5 seconds
- Fixed Seducer Passive not resetting when points are refunded
- Fixed Bristleback not appearing in Soul Pets Menu
- Fixed "Lose Items" setting always acting as enabled (For death override)
- Fixed? Pet's using wrong Desire values (Reported in 4.15, but not found in dev-build)
_____
Succubus Heart 4.15
- 4.151 - Granted Summoner XP Based on Pet Levels earned before summoner reset
- Fixed Husky not working with the train pet spell
- Fixed Horse Desire displaying incorrectly in the MCM
_____
Succubus Heart 4.14
- WARNING : Dawnguard and Dragonborn are now REQUIRED (Use 4.13 if you don't have these)
- Note : Slaves were meant to be in this patch, however thanks to some follower bugs they'll be added later.
- Changed Pet Level Scaling to 10% of the player's level
- Changed reset pet and summoner level because of value changes, stats uneffected (Sorry!)
- Changed Pet XP levels to be based on 'Tier' (What summoner level they require to unlock)
- Changed semi-grouped pets based on type (canine, beast, humanoid, resource, slave)
- Added Level Caps to Spirit and Tali
- Added Husky Soul Pet
- Added Bristleback Soul Pet
- Added Seeker Soul Pet
- Added Gargoyle Soul Pet
- Added Netch Soul Pet
- Added Riekling Soul Pet
- Fixed Soul Pets not appearing when locked
- Fixed Dog Pet not starting unlocked (making progression impossible without cheating)
- Fixed Bear Pet being impossible to unlock
- Fixed Troll unlocking at a lower tier than it should
- Fixed Missing Entries in Reference MCM Section (inside Help)
- Fixed Formal Beauty Passive Description being outdated
_____

Succubus Heart 4.13 (Note : This is the last planned version to not require DLC)
- Note : Thanks to a few bugs found in custom worldspace creation, I'll be making Succubus Heart an 'esm' internally. This should fix things like floating grass, stuck realm NPCs, and map glitches. (don't ask me why this works)
- Added option to remove pet spells from the player menu
- Added some compatibility notes in the MCM
- Changed Soul Pets are now unlocked by Summoner Level
- Changed slightly decreased Soul Pet Summoner Level Requirements
- Changed BDSM Specialties now add percentage bonuses
- Changed Formal Beauty now effected by stacks, new bonus applied for BDSM-Desire Specialty
- Changed Luscious Liquids now gets a 20% bonus for BDSM-Mind Specialty
- Changed Status Cap cost scaling to be a bit higher
- Changed all pet spells are now considered Conjuring spells
- Changed "Effect Multiplier" to "Progression Multiplier" for clarity
- Removed player visual effect when using creature summon spells (technically a fix, my game never saw them thanks to mods... woops.)
- Fixed Combat Seduction not allowing NPC to Player Submission (Broke in 4.12)
[/Spoiler] 